System.Collections.ObjectModel.KeyedCollection<TKey,TItem>. ChangeItemKey 메서드

이 문서에서는 이 API에 대한 참조 설명서에 대한 추가 설명서를 제공합니다.

메서드는 ChangeItemKey(TItem, TKey) 포함된 item키를 수정하지 않습니다. 단순히 조회 사전에 저장된 키를 대체합니다. 따라서 포함된 itemitemGetKeyForItem키와 다른 경우 .newKey

조회 사전이 없는 경우 KeyedCollection<TKey,TItem> 이 메서드는 아무 작업도 수행하지 않습니다.

모든 키는 KeyedCollection<TKey,TItem> 고유해야 합니다. 키는 .일 수 없습니다 null.

이 메서드는 O(1) 작업입니다.

구현자에 대한 참고 사항

항목에 포함된 키를 수정하기 전에 이 메서드를 호출하여 조회 사전의 키를 업데이트해야 합니다. 사전 만들기 임계값이 -1이면 이 메서드를 호출할 필요가 없습니다.

메서드를 ChangeItemKey 파생 클래스의 public 메서드로 노출하지 마세요. 이 메서드를 잘못 사용하면 조회 사전이 항목 키와 동기화되지 않습니다. 예를 들어 키를 null 설정한 다음 다른 값으로 설정하면 항목에 대한 여러 키가 조회 사전에 추가됩니다. 변경 가능한 항목 키를 허용하도록 이 메서드를 내부적으로 노출합니다. 항목의 키가 변경되면 이 메서드를 사용하여 조회 사전의 키를 변경합니다.